Three.js API手册 / LoadingManager

您所在的位置：网站首页 › loading file › Three.js API手册 / LoadingManager

Three.js API手册 / LoadingManager

#Three.js API手册 / LoadingManager| 来源: 网络整理| 查看: 265

LoadingManager

其功能时处理并跟踪已加载和待处理的数据。如果未手动设置加强管理器，则会为加载器创建和使用默认全局实例加载器管理器 - 请参阅 DefaultLoadingManager.

一般来说，默认的加载管理器已足够使用了，但有时候也需要设置单独的加载器 - 例如，如果你想为对象和纹理显示单独的加载条。

例子

WebGL / loader / babylonWebGL / loader / fbxWebGL / loader / objWebGL / materials / reflectivityWebGL / postprocesing / outlineWebGL / terrain / dynamic

下面的例子将介绍，如何使用加载管理器来跟踪 OBJLoader 的加载进度流程。

除了观察进度流程之外，还可以使用LoadingManager在加载期间覆写资源URL。当某资源来自拖拽事件、 WebSockets、WebRTC或其他API时，此方法可以有所帮助。下面显示了如何使用Blob URL加载内存模型的示例。

// 将文件拖入网页时创建的Blob或File对象。 var blobs = {'fish.gltf': blob1, 'diffuse.png': blob2, 'normal.png': blob3}; var manager = new THREE.LoadingManager(); // 使用URL回调初始化加载管理器。 var objectURLs = []; manager.setURLModifier( ( url ) => { url = URL.createObjectURL( blobs[ url ] ); objectURLs.push( url ); return url; } ); // 像通常一样加载，然后撤消blob URL var loader = new THREE.GLTFLoader( manager ); loader.load( 'fish.gltf', (gltf) => { scene.add( gltf.scene ); objectURLs.forEach( ( url ) => URL.revokeObjectURL( url ) ); }); 构造方法 LoadingManager( onLoad : Function, onProgress : Function, onError : Function )

onLoad — (可选) 所有加载器加载完成后，将调用此函数。onProgress — (可选) 当每个项目完成后，将调用此函数。onError — (可选) 当一个加载器遇到错误时，将调用此函数。创建一个新的 LoadingManager.

属性 # .onStart : Function

此换上咋加载开始时，被调用. 有如下参数:url — 被加载的项的url。itemsLoaded — 目前已加载项的个数。itemsTotal — 总共所需要加载项的个数。

此方法默认时未定义。

# .onLoad : Function

所有的项加载完成后将调用此函数。默认情况下，此方法时未定义的，除非在构造函数中进行传递。

# .onProgress : Function

此方法加载每一个项，加载完成时进行调用。有如下参数:url — 被加载的项的url。itemsLoaded — 目前已加载项的个数。itemsTotal — 总共所需要加载项的个数。

默认情况下，此方法时未定义的，除非在构造函数中进行传递。

# .onError : Function

此方法将在任意项加载错误时，进行调用。有如下参数:url — 所加载出错误的项的url

默认情况下，此方法时未定义的，除非在构造函数中进行传递。

方法 # .setURLModifier ( callback : Function ) : null

callback — 设置URL修饰符成功时回调。使用url参数进行回调，并且必须返回 resolvedURL 。

如果设置了回调，则在发送请求之前将向每个资源URL传递回调。回调可以返回最初的URL，也可以返回新URL以覆盖加载行为。此行为可用于从.ZIP、拖拽API和数据URI中加载资源文件。

# .resolveURL ( url : String ) : String

url — 所要加载的url

给定URL，使用URL修饰符回调（如果有）并返回已解析的URL。如果未设置URL修饰符，则返回原始URL。

Note: The following methods are designed to be called internally by loaders. You shouldn't call them directly.

# .itemStart ( url : String ) : null

url — 所要加载的url

任何使用管理器的加载器都会调用此方法，当加载器需要开始加载URL时。

# .itemEnd ( url : String ) : null

url — 所要加载的url

任何使用管理器的加载器都会调用此方法，当加载器需要加载URL结束时。

# .itemError ( url : String ) : null

url — 所要加载的url

任何使用管理器的加载器都会调用此方法，当加载器出现加载错误时。

源 -

src/loaders/LoadingManager.js

【本文地址】

Three.js API手册 / LoadingManager

Three.js API手册 / LoadingManager

今日新闻

推荐新闻